home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / fulpak / general.txt < prev    next >
Text File  |  1997-09-19  |  10KB  |  172 lines

  1.    Simple Windows 1.7 is a text graphic orientated Turbo C/C++ 
  2. utility. The basic system used is file allocation with a static 
  3. 18k buffering system. This system achieves a small static ram 
  4. usage with virtually unlimited capacity. Literal thousands of 
  5. windows, menus, forms, and songs can be used and the library will 
  6. remain a static 18k ram usage. The libraries are small max 54k. 
  7. The library contains window and menu management. Both screen and 
  8. print form loads. Tone and cord music routines as will as a 
  9. playsong function. There is also disk management for all opening 
  10. and closing operations including pointers. Print management for 60 
  11. line by 80 characters pages is also included as will as a 
  12. makefile editor for the load files. There are two types of 
  13. libraries, debug and no debug. Swinerrx.lib is the debug library 
  14. and contains checks on parameters and files and displays error 
  15. messages on screen. The error massage will appear and the 
  16. function will abort. The massage will contain the parameters 
  17. found bad, the function it is in and the number of the current 
  18. window. Swinx.lib contains no error detection but will return 
  19. error codes from the functions on file allocation. It is also 
  20. smaller.
  21.    All functions return 0 on success and 1 on failure except 
  22. cursor hide/show All file allocations return -1 on end of file or 
  23. _doserrno on all other fails. Printer functions _doserrno on 
  24. failure,3 on time out, and biosprint stats for any other failure 
  25. and 0 for success.  
  26.   SWSKDEF.H is the special key bios codes (F, ALT, PageUP/DN, 
  27. CURSOR) and should be included if these are to be used.
  28.   Makefile is the real heart of simple windows. It is the editor 
  29. for constructing the call files. It has help screens for every 
  30. function. All you have to do is cursor to the function and hit F1. 
  31. A help screen will then appear. 
  32.   There are six types of files 5 are for the call files themselves 
  33. (window, menu,screen forms, print forms, and songs). The sixth is 
  34. the scheme file. It is for viewing your graphics for your entire 
  35. program. The current scheme display is also used when creating 
  36. windows and menus. All file types can be loaded at once so you can 
  37. work with windows and menus or screens for a single program 
  38. without reloading.
  39.   When all your files are made they then can be call in the 
  40. program saving much coding that would be required to build them 
  41. in the program. This will make your program much smaller and also 
  42. allows you to design your graphics with out using the compiler or 
  43. ,if you use a graphic artist, knowing programing.
  44.   For now the editor is fairly crude but the upgrade will have 
  45. click drag mouse and only a single name for the files will be 
  46. needed.  
  47.   I have included 3 conversion executes to change older Simple
  48. Windows files to the new format. Convwin and Convmen will convert
  49. old menu, help files and window files to the new format. They 
  50. take one argument the file name of the file to convert. Convsng
  51. will convert the song files to the new format.
  52.   Swtotext.exe and txttosw.exe will convert menu and help files
  53. to an ASCII text format for spell checking and back to Simple
  54. Windows format. Swtotxt.exe converts a file to ASCII text. It
  55. takes an argument of the file name to convert and gives it the
  56. extension .TXT. Txttosw.exe converts the file back to Simple
  57. windows format. It takes 2 arguments the text file to convert
  58. with the extension .TXT and the file name to restore to with
  59. extension (.MEN, .HLP, ect...). I've also included Mouse21 
  60. functions lib. It's functions are almost the same as Simple
  61. Mouse 2.3 and have not been put into the online docs (fultut.exe)
  62. Any differences can be check with Fullpack.doc under Simple
  63. Windows 1.7 catagory mouse functions. I have also include 
  64. ShareSpell 3.1 to do the spell checking. It is a separate 
  65. shareware program and must be registered separately 
  66. (see Sharespell docs).
  67.  
  68.   Font Edit 1.5 is a full text graphic font management and editing
  69. program. It can display 4 text fonts plus 4 large fonts from
  70. them for a total of 8 fonts at once on the screen. Even with 8
  71. fonts full line draw capabilities are retained. All functions are
  72. easy to use and a full font editor with mouse/hotkey and help 
  73. screens is included. There are four executes (loadfont.exe,
  74. dualon.exe, setpal.exe, makefont.exe) for use with system calls.
  75.   To understand these functions some theory on dual fonts is
  76. needed. Each font is 255 characters with character 256 reserved.
  77. With dual fonts you have 510 characters to work with. Each 
  78. character is a 8x16 pixel bitmap. Characters C0 through DF are the
  79. blend characters in VGA and will use the ninth bit. VGA characters
  80. are 9x16 pixel with the 9th bit the background color except for
  81. the blend characters which the 9th bit is the same as the 8th. EGA
  82. fonts are all the same (8x14).
  83.   In dual font mode the intensity bit (attribute bit 3) selects 
  84. witch font bank you use but it all so selects the foreground color
  85. from the palette registers. So for tow fonts to display in the 
  86. same color both the high and low palette registers must be the
  87. same color.
  88.   The palette register is 16 color registers. Register 0 through 7
  89. are the low intensity colors (background colors) and register
  90. 8 through 15 are high intensity colors (foreground colors). In 
  91. dual font mode bank 0 font is displayed if the intensity bit is 0 
  92. with the low intensity color and bank 1 font is displayed if the 
  93. intensity bit is 1 with the high intensity color. This means that
  94. the low and high palette registers have to be set to the same 
  95. color to display both fonts in the same color. So to display both 
  96. fonts in yellow both palettes 6 and 14 must be set to color 63. 
  97. The palette registers can be set to one of 64 colors from the DAC
  98. (0 through 63).
  99.   Once you have set the palettes the lib will manage the attribute
  100. bit for the proper color. NOTE: the palette must be reset to the
  101. right colors when you exit. If you use the executes for font 
  102. control you the programmer must keep track of the attribute bit.
  103. For color control and editing look for VGA11B.ZIP (Vgaedit 1.1B)
  104. a fine VGA color editor with over 256k color capacity. EGA will
  105. only use the first 64 colors in the DAC and is note changeable.
  106.   With dual fonts there are 64 blend characters 32 (C0 through DF)
  107. in each bank. Only one set is needed for line draw leaving one
  108. set for something else. A 2x2 bit map requires 16 characters to
  109. produce every combination possible. Load_emulate loads this bit 
  110. map combination into one of the banks in characters C0 through 
  111. CF. These I use to produce the large fonts reproducing the bit 
  112. map of the character you wish to display in a 4x8 character size. 
  113. And to draw the clown found in the demo. Since any character is a 
  114. 8x16 bit map you can with some editing produce drawings with the
  115. resolution of 160x50 pixels.
  116.   With makefont I produce a multi font or two 96 character fonts
  117. in one bank. They are managed so that no line draw or blend
  118. characters are used and with the lib are as easy to use as just
  119. calling one of four fonts and will all (4 standard and 4 large)
  120. display at once.
  121.   The palette needs to be blocked from resetting to default
  122. colors in there is a mode reset. This is done with enable_reset()
  123. or resetpal.exe.
  124.   Init_multi_font() will set up and manage all dual font modes
  125. with one function. It loads both font banks and the palette and
  126. sets the palette to the 8 upper colors. With this function you
  127. can code and not worry about the colors not being right in your
  128. program.
  129.  
  130.   VGA EDIT 1.3 is a full VGA color editor and management utility 
  131. for DOS and Turbo C/C++. All palette and DAC register settings 
  132. can be edited and saved to files which are easily loaded with a 
  133. single call. This allows you (the developer) to use the complete 
  134. color capabilities of VGA in text graphics modes. You can get 16 
  135. out of over 256k color combinations. The color scheme of you 
  136. product and literally change with every key stroke giving you true 
  137. graphics color with the speed of text and smallness of text 
  138. graphics.
  139.   The editor (vgaedit.exe) is f